package com.mars.admin.modules.post.service;

import com.mars.admin.modules.base.service.BaseService;
import com.mars.admin.modules.post.entity.TopicFollow;
import com.mybatisflex.core.paginate.Page;

import java.util.List;

/**
 * 话题关注服务接口
 *
 * @author Mars
 * @version 1.0
 * @date 2025-01-07
 */
public interface ITopicFollowService extends BaseService<TopicFollow> {

    /**
     * 关注话题
     *
     * @param userId 用户ID
     * @param topicId 话题ID
     * @return 是否成功
     */
    boolean followTopic(Long userId, Long topicId);

    /**
     * 取消关注话题
     *
     * @param userId 用户ID
     * @param topicId 话题ID
     * @return 是否成功
     */
    boolean unfollowTopic(Long userId, Long topicId);

    /**
     * 检查用户是否关注了话题
     *
     * @param userId 用户ID
     * @param topicId 话题ID
     * @return 是否关注
     */
    boolean isFollowing(Long userId, Long topicId);

    /**
     * 查询用户关注的话题列表
     *
     * @param userId 用户ID
     * @param page 分页参数
     * @return 关注的话题列表
     */
    Page<TopicFollow> getUserFollowedTopics(Long userId, Page<TopicFollow> page);

    /**
     * 查询话题的关注用户列表
     *
     * @param topicId 话题ID
     * @param page 分页参数
     * @return 关注的用户列表
     */
    Page<TopicFollow> getTopicFollowers(Long topicId, Page<TopicFollow> page);

    /**
     * 查询用户关注的话题ID列表
     *
     * @param userId 用户ID
     * @return 话题ID列表
     */
    List<Long> getUserFollowedTopicIds(Long userId);

    /**
     * 查询话题的关注用户ID列表
     *
     * @param topicId 话题ID
     * @return 用户ID列表
     */
    List<Long> getTopicFollowerIds(Long topicId);

    /**
     * 统计话题的关注数量
     *
     * @param topicId 话题ID
     * @return 关注数量
     */
    int countTopicFollowers(Long topicId);

    /**
     * 统计用户关注的话题数量
     *
     * @param userId 用户ID
     * @return 关注的话题数量
     */
    int countUserFollowedTopics(Long userId);

    /**
     * 查询热门关注的话题ID列表
     *
     * @param limit 限制数量
     * @return 话题ID列表
     */
    List<Long> getHotFollowedTopicIds(Integer limit);
} 